<!DOCTYPE html>
<html lang="en">

<head>
	<meta charset="UTF-8">
	<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no">
	<meta name="keywords" content="Nacos,FAQ" />
	<meta name="description" content="Nacos FAQ" />
	<!-- 网页标签标题 -->
	<title>FAQ</title>
	<link rel="shortcut icon" href="https://img.alicdn.com/tfs/TB1hgJpHAPoK1RjSZKbXXX1IXXa-64-64.png"/>
	<link rel="stylesheet" href="/build/documentation.css" />
</head>
<body>
	<div id="root"><div class="documentation-page" data-reactroot=""><header class="header-container header-container-normal"><div class="header-body"><a href="/en-us/index.html"><img class="logo" src="/img/nacos_colorful.png"/></a><div class="search search-normal"><span class="icon-search"></span></div><span class="language-switch language-switch-normal">中</span><div class="header-menu"><img class="header-menu-toggle" src="/img/menu_gray.png"/><ul><li class="menu-item menu-item-normal"><a href="/en-us/index.html">HOME</a></li><li class="menu-item menu-item-normal menu-item-normal-active"><a href="/en-us/docs/quick-start.html">DOCS</a></li><li class="menu-item menu-item-normal"><a href="/en-us/blog">BLOG</a></li><li class="menu-item menu-item-normal"><a href="/en-us/community">COMMUNITY</a></li><li class="menu-item menu-item-normal"><a href="https://cn.aliyun.com/product/aliware/mse?spm=nacos-website.topbar.0.0.0">NACOS IN CLOUD</a><img class="menu-img" src="https://img.alicdn.com/tfs/TB1esl_m.T1gK0jSZFrXXcNCXXa-200-200.png"/></li><li class="menu-item menu-item-normal"><a href="http://console.nacos.io/nacos/index.html">DEMO-CONSOLE</a></li></ul></div></div></header><div class="bar"><div class="bar-body"><img src="/img/docs.png" class="front-img"/><div class="bar-title"><span>Documentation</span><div class="bone bone-light"></div></div><img src="/img/docs.png" class="back-img"/></div></div><section class="content-section"><div class="content-body"><div class="sidemenu"><div class="sidemenu-toggle"><img src="https://img.alicdn.com/tfs/TB1E6apXHGYBuNjy0FoXXciBFXa-200-200.png"/></div><ul><li class="menu-item menu-item-level-1"><span>Nacos </span><ul><li style="height:180px;overflow:hidden" class="menu-item menu-item-level-2"><span>What is Nacos<img style="transform:rotate(0deg)" class="menu-toggle" src="/img/arrow_down.png"/></span><ul><li class="menu-item menu-item-level-3"><a href="/en-us/docs/what-is-nacos.html" target="_self">What is Nacos</a></li><li class="menu-item menu-item-level-3"><a href="/en-us/docs/concepts.html" target="_self">Concepts</a></li><li class="menu-item menu-item-level-3"><a href="/en-us/docs/architecture.html" target="_self">Architecure</a></li><li class="menu-item menu-item-level-3"><a href="/en-us/docs/feature-list.html" target="_self">Feature list</a></li></ul></li><li style="height:324px;overflow:hidden" class="menu-item menu-item-level-2"><span>Quick Start<img style="transform:rotate(0deg)" class="menu-toggle" src="/img/arrow_down.png"/></span><ul><li class="menu-item menu-item-level-3"><a href="/en-us/docs/quick-start.html" target="_self">Nacos</a></li><li class="menu-item menu-item-level-3"><a href="/en-us/docs/quick-start-spring.html" target="_self">Nacos Spring</a></li><li class="menu-item menu-item-level-3"><a href="/en-us/docs/quick-start-spring-boot.html" target="_self">Nacos Spring Boot</a></li><li class="menu-item menu-item-level-3"><a href="/en-us/docs/quick-start-spring-cloud.html" target="_self">Nacos Spring Cloud</a></li><li class="menu-item menu-item-level-3"><a href="/en-us/docs/quick-start-docker.html" target="_self">Nacos Docker</a></li><li class="menu-item menu-item-level-3"><a href="/en-us/docs/use-nacos-with-dubbo.html" target="_self">Nacos with Dubbo</a></li><li class="menu-item menu-item-level-3"><a href="/en-us/docs/use-nacos-with-kubernetes.html" target="_self">Nacos with K8s</a></li><li class="menu-item menu-item-level-3"><a href="/en-us/docs/nacos-sync.html" target="_self">Nacos Sync</a></li></ul></li><li style="height:288px;overflow:hidden" class="menu-item menu-item-level-2"><span>User Guide<img style="transform:rotate(0deg)" class="menu-toggle" src="/img/arrow_down.png"/></span><ul><li class="menu-item menu-item-level-3"><a href="/en-us/docs/sdk.html" target="_self">Java SDK</a></li><li class="menu-item menu-item-level-3"><a href="/en-us/docs/other-language.html" target="_self">Other Language</a></li><li class="menu-item menu-item-level-3"><a href="/en-us/docs/open-api.html" target="_self">Open-API</a></li><li class="menu-item menu-item-level-3"><a href="/en-us/docs/nacos-spring.html" target="_self">Nacos Spring</a></li><li class="menu-item menu-item-level-3"><a href="/en-us/docs/system-configurations.html" target="_self">Nacos System Configurations</a></li><li class="menu-item menu-item-level-3"><a href="/en-us/docs/auth.html" target="_self">Authentication</a></li><li class="menu-item menu-item-level-3"><a href="/en-us/docs/faq.html" target="_self">FAQ</a></li></ul></li><li style="height:36px;overflow:hidden" class="menu-item menu-item-level-2"><span>Admin Guide<img style="transform:rotate(-90deg)" class="menu-toggle" src="/img/arrow_down.png"/></span><ul><li class="menu-item menu-item-level-3"><a href="/en-us/docs/deployment.html" target="_self">Deployment Guide</a></li><li class="menu-item menu-item-level-3"><a href="/en-us/docs/cluster-mode-quick-start.html" target="_self">Cluster Mode Deployment</a></li><li class="menu-item menu-item-level-3"><a href="/en-us/docs/management-api.html" target="_self">Management OpenAPI</a></li><li class="menu-item menu-item-level-3"><a href="/en-us/docs/console-guide.html" target="_self">Admin Console Guide</a></li><li class="menu-item menu-item-level-3"><a href="/en-us/docs/monitor-guide.html" target="_self">Nacos Monitor Guide</a></li><li class="menu-item menu-item-level-3"><a href="/en-us/docs/nacos-config-benchmark.html" target="_self">Nacos Config Benchmark</a></li><li class="menu-item menu-item-level-3"><a href="/en-us/docs/nacos2-config-benchmark.html" target="_self">Nacos2.0 Config Benchmark</a></li><li class="menu-item menu-item-level-3"><a href="/en-us/docs/nacos-naming-benchmark.html" target="_self">Nacos Naming Benchmark</a></li><li class="menu-item menu-item-level-3"><a href="/en-us/docs/nacos2-naming-benchmark.html" target="_self">Nacos2.0 Naming Benchmark</a></li><li class="menu-item menu-item-level-3"><a href="/en-us/docs/nacos-sync-use.html" target="_self">Data Migration to Nacos</a></li></ul></li><li style="height:36px;overflow:hidden" class="menu-item menu-item-level-2"><span>Nacos 2.0<img style="transform:rotate(-90deg)" class="menu-toggle" src="/img/arrow_down.png"/></span><ul><li class="menu-item menu-item-level-3"><a href="/zh-cn/docs/2.0.0-alpha.html" target="_self">2.0-BETA</a></li><li class="menu-item menu-item-level-3"><a href="/zh-cn/docs/2.0.0-upgrading.html" target="_self">Upgrading</a></li></ul></li><li style="height:36px;overflow:hidden" class="menu-item menu-item-level-2"><span>Contributor Guide<img style="transform:rotate(-90deg)" class="menu-toggle" src="/img/arrow_down.png"/></span><ul><li class="menu-item menu-item-level-3"><a href="/en-us/docs/contributing.html" target="_self">Contribute to Nacos</a></li><li class="menu-item menu-item-level-3"><a href="/en-us/docs/contributing-flow.html" target="_self">Contributing Flow</a></li><li class="menu-item menu-item-level-3"><a href="/en-us/docs/pull-request.html" target="_self">Pull Request Template</a></li><li class="menu-item menu-item-level-3"><a href="/en-us/docs/how-to-reporting-bugs.html" target="_self">How to report bugs</a></li></ul></li><li style="height:36px;overflow:hidden" class="menu-item menu-item-level-2"><span>Community<img style="transform:rotate(-90deg)" class="menu-toggle" src="/img/arrow_down.png"/></span><ul><li class="menu-item menu-item-level-3"><a href="/en-us/docs/community.html" target="_self">Community</a></li><li class="menu-item menu-item-level-3"><a href="/en-us/docs/nacos-dev.html" target="_self">Develop Team</a></li></ul></li></ul></li></ul></div><div class="doc-content markdown-body"><h1>FAQ</h1>
<ul>
<li>
<p>Nacos standard questions</p>
<ul>
<li><a href="#1.1">What is Nacos</a></li>
<li><a href="#1.2">Nacos how to support more than the environment</a></li>
<li><a href="#1.3">Nacos whether production is available</a></li>
<li><a href="#1.4">Nacos version plan</a></li>
<li><a href="#1.5">Nacos dependent</a></li>
<li><a href="#1.6">Nacos using open source licenses</a></li>
</ul>
</li>
<li>
<p>Nacos operational questions</p>
<ul>
<li><a href="#2.1">Nacos standalone deployment</a></li>
<li><a href="#2.2">Nacos standalone deployment using Mysql</a></li>
<li><a href="#2.3">Nacos production deployment</a></li>
<li><a href="#2.4">Nacos Docker deployment</a></li>
<li><a href="#2.5">How to deploy in k8s Nacos</a></li>
<li><a href="#2.6">How to monitor Nacos</a></li>
</ul>
</li>
<li>
<p>Nacos used questions</p>
<ul>
<li><a href="#3.1">Zookeeper service can be migrated to Nacos?</a></li>
<li><a href="#3.2">Nacos support multiple configuration files</a></li>
<li><a href="#3.3">Nacos support Dubbo</a></li>
<li><a href="#3.4">Nacos support Spring system</a></li>
<li><a href="#3.5">Don't use Nacos SDK how to access the Nacos</a></li>
<li><a href="#3.6">Nacos support for multiple languages</a></li>
<li><a href="#3.7">Nacos 0.8 version logon failure</a></li>
<li><a href="#3.8">Server error <code>java.lang.IllegalStateException: unable to find local peer: 127.0.0.1:8848</code></a></li>
<li><a href="#3.9">Nacos configuration for encryption</a></li>
<li><a href="#3.10">Nacos at 401 error</a></li>
<li><a href="#3.11">Nacos weight not to take effect</a></li>
<li><a href="#3.12">Nacos how to enlarge shrinks capacity</a></li>
<li><a href="#3.13">Nacos client modify the log level</a></li>
<li><a href="#3.14">Nacos and Zipkin integration <code>Service not found</code> error</a></li>
<li><a href="#3.15">Why service registration is successful, the console can't see</a></li>
<li><a href="#3.19"><code>com.alibaba.nacos.consistency.entity</code> can't be found in source codes</a></li>
</ul>
</li>
<li>
<p>Nacos principle questions</p>
</li>
</ul>
<h2>Nacos standard questions</h2>
<h4 id="1.1">What is Nacos</h4>
<p>Nacos dedicated to help you find, micro configuration and management services. Nacos provides a set of simple and easy to use feature set, help you quickly realize dynamic service discovery, service configuration, service metadata, and traffic management. Details you can refer to <a href="https://nacos.io/en-us/docs/what-is-nacos.html">Nacos website</a>.</p>
<h4 id="1.2">Nacos how to support more than the environment</h4>
<p>In daily use are often need different environment, such as daily, pretest, online environment, if it is a logical isolation, can use the namespace Nacos support namespace to support more environmental isolation, can create multiple namespaces in Nacos console. If you need physical isolation, will deploy more sets of Nacos environment.</p>
<h4 id="1.3">Nacos whether production is available</h4>
<p>Nacos in January 2019 issued a Pre - GA version, to support the security isolation, monitoring and service migration on the last mile of production, in a more stable support the user's production environment. Details you can refer to <a href="https://www.oschina.net/news/104019/nacos-0-8-0-pre-ga">Nacos release v0.8.0 Pre - GA version, the safe and stable production</a>.</p>
<h4 id="1.4">Nacos version plan</h4>
<p>Nacos 0.8.0 to support production available, version 1.0 to mass production is available, version 2.0 plan and K8s, Spring Cloud, and further integration Service Mesh, Serverless, details you can refer to <a href="https://nacos.io/en-us/docs/roadmap.html">Nacos roadmap</a>.</p>
<h4 id="1.5">Nacos dependent</h4>
<p>In stand-alone mode, Nacos without any rely on, in cluster mode, Nacos rely on Mysql storage, details you can refer to <a href="https://nacos.io/en-us/docs/deployment.html">Nacos deployment</a>.</p>
<h4 id="1.6">Nacos using open source licenses</h4>
<p>Nacos using <a href="https://github.com/alibaba/nacos/blob/master/LICENSE">Apache 2.0</a>.</p>
<h2>Nacos operational questions</h2>
<h4 id="2.1">Nacos standalone deployment</h4>
<p>You can refer to the manual Nacos website deployment <a href="https://nacos.io/en-us/docs/quick-start.html">quick start</a>.</p>
<h4 id="2.2">Nacos standalone deployment using Mysql</h4>
<p>Nacos stand-alone mode defaults to using the embedded database as the storage engine, if you want to change your mysql installation, you can refer to <a href="https://nacos.io/en-us/docs/deployment.html">website document</a>.</p>
<h4 id="2.3">Nacos production deployment</h4>
<p>Production environment using Nacos in order to achieve high availability cannot use stand-alone mode, need to build Nacos cluster, specific details can refer to <a href="https://nacos.io/en-us/docs/cluster-mode-quick-start.html">the manual cluster deployment</a>.</p>
<h4 id="2.4">Nacos Docker deployment</h4>
<p>In addition to using compressed package deployment Nacos, Nacos also provides a corresponding Docker image, when Nacos release new versions, Nacos will release the corresponding image version supports Docker deployment.Specific details you can refer to <a href="https://nacos.io/en-us/docs/quick-start-docker.html">Nacos Docker</a>.</p>
<h4 id="2.5">How to deploy in k8s Nacos</h4>
<p>In production deployment Nacos cluster, if for Nacos expansion operation, need to manually change the cluster IP file, start a new Nacos <a href="http://service.In">service.In</a> order to automate operations, k8s Nacos and combined use of StatefulSets provides automatic operations plan, to dynamic scalability Nacos capacity, specific details reference <a href="https://github.com/nacos-group/nacos-k8s/blob/master/README.md">Kubernetes Nacos</a>.</p>
<h4 id="2.6">How to monitor Nacos</h4>
<p>Nacos0.8 version provides the Metrics data exposed ability, can pass the Metrics data to monitor the running status of Nacos, the content of the details you can refer to <a href="https://nacos.io/en-us/docs/monitor-guide.html">Nacos monitor</a>.</p>
<h2>Nacos used questions</h2>
<h4 id="3.1">Zookeeper service can be migrated to Nacos?</h4>
<p>Can through the Nacos - Sync moved the Zookeeper service and Nacos, can also be migrated from Nacos Zookeeper, specific details can be used as <a href="https://github.com/paderlol/nacos-sync-example">Nacos Sync reference</a>.</p>
<h4 id="3.2">Nacos support multiple configuration files</h4>
<p>Nacos through Spring Cloud Alibaba Nacos Config support multiple configuration files, configuration can be stored in a separate configuration file.The associated <a href="https://github.com/alibaba/nacos/issues/320">issue</a>, details refer to the document <a href="https://github.com/spring-cloud-incubator/spring-cloud-alibaba/wiki/Nacos-config">Spring Cloud Alibaba Nacos Config</a>.</p>
<h4 id="3.3">Nacos support Dubbo</h4>
<p>Nacos version 0.6 and Dubbo integration, support the use of Nacos as registry, related <a href="https://github.com/alibaba/nacos/issues/390">issue</a>, details refer to the document <a href="https://nacos.io/en-us/docs/use-nacos-with-dubbo.html">Nacos and Dubbo fusion become registry</a>.</p>
<h4 id="3.4">Nacos support Spring system</h4>
<p>Nacos perfect supports the Sping technology stack, details refer to the document <a href="https://nacos.io/en-us/docs/quick-start-spring.html">Nacos Spring</a>、<a href="https://nacos.io/en-us/docs/quick-start-spring-boot.html">Nacos Spring Boot</a>、<a href="https://nacos.io/en-us/docs/quick-start-spring-cloud.html">Spring Cloud</a>.</p>
<h4 id="3.5">Don't use Nacos SDK how to access the Nacos</h4>
<p>Nacos network interaction is implemented based on Http protocol, provides the <a href="(https://nacos.io/en-us/docs/open-api.html)">Open-API</a> can easily achieve Nacos access.</p>
<h4 id="3.6">Nacos support for multiple languages</h4>
<p>Nacos currently only supports Java, support for other languages are being developed, also need your support to build together.</p>
<h4 id="3.7">Nacos 0.8 version logon failure</h4>
<p>Nacos version 0.8 when using its and no <code>JAVA_HOME</code> environment variable, Nacos can launch successful, because <code>yum install</code> installed its the Java command to register a beneath <code>/bin</code> directory, and so can cause abnormal <code>SignatureException</code>.This problem has been repair, version 0.9 release, the specific details can refer to the <a href="https://github.com/alibaba/nacos/issues/711">issue</a>.</p>
<h4 id="3.8">Server error java.lang.IllegalStateException: unable to find local peer: 127.0.0.1:8848</h4>
<p>This problem because Nacos get native IP, don't get to the correct external IP. The need to guarantee the <code>InetAddress.getLocalHost().getHostAddress()</code> or the result of the <code>hostname -i</code> was with the cluster. The conf configuration of IP is the same.</p>
<h4 id="3.9">Nacos configuration for encryption</h4>
<p>Nacos plan in 1.X version's ability to provide encryption, currently does not support encryption, can only rely on the SDK prepared encryption endures Nacos again.</p>
<h4 id="3.10">Nacos at 401 error</h4>
<p>Nacos server error, check the server logs, refer to the <a href="https://github.com/alibaba/nacos/issues/816">issue</a>.</p>
<h4 id="3.11">Nacos weight not to take effect</h4>
<p>Nacos console editors weights, at present from SpringCloud client and Dubbo client didn't get through, so can't take effect. For SpringCloud client application can realize the load balancer Ribbon for weighting filter.</p>
<h4 id="3.12">Nacos how to enlarge shrinks capacity</h4>
<p>Currently supported modify the <code>cluster.conf</code> file in a way that expanding capacity, after the change without restart, the Server will automatically refresh the new content to the file.</p>
<h4 id="3.13">Nacos client modify the log level</h4>
<p>Configuration - D parameters <code>com.alibaba.nacos.naming.log.level</code> set naming the client log level, such as setting for the error:<code>-Dcom.alibaba.nacos.naming.log.level=error</code> Similarly, - D parameters <code>com.alibaba.nacos.config.log.level</code> is used to set the config client log level.</p>
<h4 id="3.14">Nacos and Zipkin integration Service not found error</h4>
<p>Configuration <code>spring-cloud-seluth</code> parameters: <code>spring.zipkin.discovery-client-enabled=false</code>.</p>
<p>If there is still a <code>Service not found</code> error, is recommended to use the open-api will Zipkin-server instance is registered as a permanent Service:</p>
<p><code>curl -X POST 'http://127.0.0.1:8848/nacos/v1/ns/instance?port=9411&amp;healthy=true&amp;ip=127.0.0.1&amp;weight=1.0&amp;serviceName=zipkin-server&amp;ephemeral=false&amp;namespaceId=public'</code></p>
<p>Then, went to nacos console, find a service called <code>zipkin-server</code> service, find the cluster configuration, set the health examination mode to <code>TCP</code>, port number of <code>9411</code> (zipkin-server port).</p>
<h4 id="3.15">Why service registration is successful, the console can't see</h4>
<p>This problem appeared in cluster mode, in the use of nacos cluster pattern, ensure that all of the machine time is consistent, can appear otherwise unable to synchronize data.</p>
<h4 id="3.19"> `com.alibaba.nacos.consistency.entity` can't be found in source codes</h4>
<p>This package will be auto-generated by <code>protobuf</code>, so if you want to read source code or do some develop, you can use <code>mvn compile</code> to generate them. If you are using IDEA, you can also use IDEA's protobuf plugin.</p>
<h2>Nacos principle questions</h2>
</div></div></section><footer class="footer-container"><div class="footer-body"><img src="/img/nacos_gray.png"/><div class="cols-container"><div class="col col-12"><h3>Vision</h3><p>By providing an easy-to-use service infrastructure such as dynamic service discovery, service configuration, service sharing and management and etc., Nacos help users better construct, deliver and manage their own service platform, reuse and composite business service faster and deliver value of business innovation more quickly so as to win market for users in the era of cloud native and in all cloud environments, such as private, mixed, or public clouds.</p></div><div class="col col-6"><dl><dt>Documentation</dt><dd><a href="/en-us/docs/what-is-nacos.html" target="_self">Overview</a></dd><dd><a href="/en-us/docs/quick-start.html" target="_self">Quick start</a></dd><dd><a href="/en-us/docs/contributing.html" target="_self">Developer guide</a></dd></dl></div><div class="col col-6"><dl><dt>Resources</dt><dd><a href="/en-us/community/index.html" target="_self">Community</a></dd><dd><a href="https://cn.aliyun.com/product/aliware/mse?spm=nacos-website.topbar.0.0.0" target="_self">Cloud Service MSE</a></dd><dd><a href="https://www.aliyun.com/product/edas?source_type=nacos_pc_20181219" target="_self">Cloud Service EDAS</a></dd><dd><a href="https://www.aliyun.com/product/ahas?source_type=nacos_pc_20190225" target="_self">Cloud Service AHAS</a></dd></dl></div></div><div class="copyright"><span>@ 2018 The Nacos Authors | An Alibaba Middleware (Aliware) Project</span></div></div></footer></div></div>
	<script src="https://f.alicdn.com/react/15.4.1/react-with-addons.min.js"></script>
	<script src="https://f.alicdn.com/react/15.4.1/react-dom.min.js"></script>
	<script>
		window.rootPath = '';
  </script>
	<script src="/build/documentation.js"></script>
</body>
</html>